PortOne Server SDK for JVM/io.portone.sdk.server.payment.billingkey

Package-level declarations

Types

@Serializable

data class BillingKeyFailure(val failedAt: @Serializable(with = InstantSerializer::class) Instant, val message: String? = null, val pgCode: String? = null, val pgMessage: String? = null)

발급 실패 상세 정보

BillingKeyFilterInput

@Serializable

data class BillingKeyFilterInput(val storeId: String? = null, val timeRangeField: BillingKeyTimeRangeField? = null, val from: @Serializable(with = InstantSerializer::class) Instant? = null, val until: @Serializable(with = InstantSerializer::class) Instant? = null, val status: List<BillingKeyStatus>? = null, val channelGroupIds: List<String>? = null, val customerId: String? = null, val platformType: PaymentClientType? = null, val textSearch: BillingKeyTextSearch? = null, val pgProviders: List<PgProvider>? = null, val pgCompanies: List<PgCompany>? = null, val methods: List<BillingKeyPaymentMethodType>? = null, val version: PortOneVersion? = null)

빌링키 다건 조회를 위한 입력 정보

BillingKeyInfo

@Serializable

sealed interface BillingKeyInfo

빌링키 정보

BillingKeyInfoSummary

@Serializable

data class BillingKeyInfoSummary(val billingKey: String, val issuedAt: @Serializable(with = InstantSerializer::class) Instant, val channels: List<SelectedChannel>? = null)

BillingKeyPaymentMethod

@Serializable

sealed interface BillingKeyPaymentMethod

빌링키 발급 수단 정보

BillingKeyPaymentMethodCard

@Serializable

@SerialName(value = "BillingKeyPaymentMethodCard")

data class BillingKeyPaymentMethodCard(val card: Card? = null) : BillingKeyPaymentMethod, BillingKeyPaymentMethodEasyPayMethod

카드 정보

BillingKeyPaymentMethodEasyPay

@Serializable

@SerialName(value = "BillingKeyPaymentMethodEasyPay")

data class BillingKeyPaymentMethodEasyPay(val provider: EasyPayProvider? = null, val method: BillingKeyPaymentMethodEasyPayMethod? = null) : BillingKeyPaymentMethod

간편 결제 정보

BillingKeyPaymentMethodEasyPayCharge

@Serializable

@SerialName(value = "BillingKeyPaymentMethodEasyPayCharge")

data object BillingKeyPaymentMethodEasyPayCharge : BillingKeyPaymentMethodEasyPayMethod

충전식 포인트 결제 정보

BillingKeyPaymentMethodEasyPayMethod

@Serializable

sealed interface BillingKeyPaymentMethodEasyPayMethod

간편 결제 수단

BillingKeyPaymentMethodMobile

@Serializable

@SerialName(value = "BillingKeyPaymentMethodMobile")

data class BillingKeyPaymentMethodMobile(val phoneNumber: String? = null) : BillingKeyPaymentMethod

모바일 정보

BillingKeyPaymentMethodPaypal

@Serializable

@SerialName(value = "BillingKeyPaymentMethodPaypal")

data object BillingKeyPaymentMethodPaypal : BillingKeyPaymentMethod

페이팔 정보

BillingKeyPaymentMethodTransfer

@Serializable

@SerialName(value = "BillingKeyPaymentMethodTransfer")

data class BillingKeyPaymentMethodTransfer(val bank: Bank? = null, val accountNumber: String? = null) : BillingKeyPaymentMethod, BillingKeyPaymentMethodEasyPayMethod

계좌이체 정보

BillingKeyPaymentMethodType

@Serializable

enum BillingKeyPaymentMethodType : Enum<BillingKeyPaymentMethodType>

빌링키 결제 수단

BillingKeySortBy

@Serializable

enum BillingKeySortBy : Enum<BillingKeySortBy>

빌링키 정렬 기준

BillingKeySortInput

@Serializable

data class BillingKeySortInput(val by: BillingKeySortBy? = null, val order: SortOrder? = null)

빌링키 다건 조회 시 정렬 조건

BillingKeyStatus

@Serializable

enum BillingKeyStatus : Enum<BillingKeyStatus>

빌링키 상태

BillingKeyTextSearch

@Serializable

data class BillingKeyTextSearch(val field: BillingKeyTextSearchField, val value: String)

통합검색 입력 정보

BillingKeyTextSearchField

@Serializable

enum BillingKeyTextSearchField : Enum<BillingKeyTextSearchField>

통합검색 항목

BillingKeyTimeRangeField

@Serializable

enum BillingKeyTimeRangeField : Enum<BillingKeyTimeRangeField>

빌링키 다건 조회 시, 시각 범위를 적용할 필드

ChannelSpecificFailure

@Serializable

sealed interface ChannelSpecificFailure

ChannelSpecificFailureInvalidRequest

@Serializable

@SerialName(value = "INVALID_REQUEST")

data class ChannelSpecificFailureInvalidRequest(val channel: SelectedChannel, val message: String? = null) : ChannelSpecificFailure

요청된 입력 정보가 유효하지 않은 경우

ChannelSpecificFailurePgProvider

@Serializable

@SerialName(value = "PG_PROVIDER")

data class ChannelSpecificFailurePgProvider(val channel: SelectedChannel, val pgCode: String, val pgMessage: String, val message: String? = null) : ChannelSpecificFailure

PG사에서 오류를 전달한 경우

DeleteBillingKeyResponse

@Serializable

data class DeleteBillingKeyResponse(val deletedAt: @Serializable(with = InstantSerializer::class) Instant)

빌링키 삭제 성공 응답

DeletedBillingKeyInfo

@Serializable

@SerialName(value = "DELETED")

data class DeletedBillingKeyInfo(val billingKey: String, val merchantId: String, val storeId: String, val channels: List<SelectedChannel>, val customer: Customer, val issuedAt: @Serializable(with = InstantSerializer::class) Instant, val deletedAt: @Serializable(with = InstantSerializer::class) Instant, val methods: List<BillingKeyPaymentMethod>? = null, val customData: String? = null, val issueId: String? = null, val issueName: String? = null, val requestedAt: @Serializable(with = InstantSerializer::class) Instant? = null, val channelGroup: ChannelGroupSummary? = null, val pgBillingKeyIssueResponses: List<PgBillingKeyIssueResponse>? = null) : BillingKeyInfo

빌링키 삭제 완료 상태 건

FailedPgBillingKeyIssueResponse

@Serializable

@SerialName(value = "FAILED")

data class FailedPgBillingKeyIssueResponse(val channel: SelectedChannel, val failure: BillingKeyFailure) : PgBillingKeyIssueResponse

빌링키 발급 실패 채널 응답

GetBillingKeyInfosResponse

@Serializable

data class GetBillingKeyInfosResponse(val items: List<BillingKeyInfo>, val page: PageInfo)

빌링키 다건 조회 성공 응답 정보

InstantBillingKeyPaymentMethodInput

@Serializable

data class InstantBillingKeyPaymentMethodInput(val card: InstantBillingKeyPaymentMethodInputCard? = null)

빌링키 발급 시 결제 수단 입력 양식

InstantBillingKeyPaymentMethodInputCard

@Serializable

data class InstantBillingKeyPaymentMethodInputCard(val credential: CardCredential)

카드 수단 정보 입력 양식

IssueBillingKeyResponse

@Serializable

data class IssueBillingKeyResponse(val billingKeyInfo: BillingKeyInfoSummary, val channelSpecificFailures: List<ChannelSpecificFailure>? = null)

빌링키 발급 성공 응답

IssuedBillingKeyInfo

@Serializable

@SerialName(value = "ISSUED")

data class IssuedBillingKeyInfo(val billingKey: String, val merchantId: String, val storeId: String, val channels: List<SelectedChannel>, val customer: Customer, val issuedAt: @Serializable(with = InstantSerializer::class) Instant, val methods: List<BillingKeyPaymentMethod>? = null, val customData: String? = null, val issueId: String? = null, val issueName: String? = null, val requestedAt: @Serializable(with = InstantSerializer::class) Instant? = null, val channelGroup: ChannelGroupSummary? = null, val pgBillingKeyIssueResponses: List<PgBillingKeyIssueResponse>? = null) : BillingKeyInfo

빌링키 발급 완료 상태 건

IssuedPgBillingKeyIssueResponse

@Serializable

@SerialName(value = "ISSUED")

data class IssuedPgBillingKeyIssueResponse(val channel: SelectedChannel, val pgTxId: String? = null, val method: BillingKeyPaymentMethod? = null) : PgBillingKeyIssueResponse

빌링키 발급 성공 채널 응답

PgBillingKeyIssueResponse

@Serializable

sealed interface PgBillingKeyIssueResponse

채널 별 빌링키 발급 응답